Skip to content

Update Alt text for the ESD mitigation page. #340

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 14 commits into
base: main
Choose a base branch
from

Conversation

acharraggi
Copy link
Collaborator

Also tested using a Codespace to make the change. Worked pretty well.

@acharraggi
Copy link
Collaborator Author

I think this is ready for review again. There was some Slack and Discord discussion ESD shutting down Wifi if a camera was connected to the USB 2.0 port. I've added a warning about using the USB 2.0 port on a few pages. I also updated the Alt Text for those pages and add a new section Cameras and USB Hubs to the configuring-external-webcam page. This indicates you can connect two webcams to the USB 3 port by using a USB hub.

However, it's no longer a simple one page change. Now 7 pages have been updated, and two new images added.
You can see these pages live at Read the Docs:
https://first-tech-challenge-ftcdocs--340.com.readthedocs.build/en/340/hardware_and_software_configuration/configuring/managing_esd/managing-esd.html

@acharraggi
Copy link
Collaborator Author

Restored some image centering on some pages since that is how they were initially set up. Did not center images on other pages, if the original page was setup that way.

I wasn't happy with how some images are too big in the PDF, or get stretched. Images that are portrait or images that are small. The PDF formatting process seems to want to expand the image to fill the width, so either they are too big, or get stretched and look pixelated.

Images that are 800 to 1000 pixels wide don't seem to have this problem.
Turns out one way to prevent that is to set the image height to how tall you want the image, then add white space to the image horizontally so that it's about 800 or so pixels wide. This usually means the images are presented about the same size in both HTML and PDF.

So for example the picture of the Staticide bottles is a portrait image and in the PDF the image fills a page. It doesn't need to be so big. By setting the height to a reasonable size, I expanded the white space around the image to make the width 800 pixels. Now the image looks good in both HTML and PDF.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants